
                                                                   PMPUnzip

                                              A ZIP File Extractor for the Apple IIGS

                                                               by Paul Parkhurst

                                                      Version 2.0,  July 15, 1993


          Copyright  1992-1993 by Parkhurst Micro Products.  All Rights Reserved.



                                                             Shareware Notice
	This program is shareware.  You may use it free of charge for two weeks.  If, at the end of this period, you wish to continue using it, please send the $15 shareware fee to Parkhurst Micro Products, 2491 San Ramon Valley Blvd, Suite 1-317, San Ramon, CA, 94583.  If, at the end of two weeks, you have not sent in your shareware fee, please delete any copies of the software you have.
	Sending in the shareware fee will help support my continued efforts for writing shareware for the Apple IIGS.  I will also send you a diskette with the most current version of the software, send out free updates for any minor revision of the software, and give you a 20% discount on the purchase of ANSITerm Telecommunications software for the Apple IIGS (see the ad at the end of this documentation).
	If you have paid the shareware fee for previous versions of PMPUnzip, you can receive a new diskette (and free updates for all version 2.x releases) for an additional $5.


_________________________________________________________________________

Distribution - Permission is given to freely distribute the archive containing PMPUnzip as long as none of the files contained in the archive  are modified or changed in any way.  Permission is also given for bulletin boards and online services to keep the archive containing PMPUnzip indefinitely so long as the archive remains available for download by the users.

Warranty and Disclaimer - Paul Parkhurst (dba Parkhurst Micro Products) makes no warranties, whether expressed or implied, regarding the merchantiblity or fitness of this software for any particular purpose.  The sole risk of its use is up to the user.  Paul Parkhurst shall have no liability or responsibility to the purchaser or any other party or entity with respect to the liability, loss, or damage caused by or alleged to be caused directly or indirectly by this product, including but not limited to any interruption of service, loss of business and anticipatory profits or consequential damages resulting from the use or operation of this product.

All product names are trademarks of their respective manufacturers.
_________________________________________________________________________

If you have any comments or questions, I can be reached electronically at the following locations:

	Infinity's Edge BBS, (510) 820-9401 (300-14400 HST/V.32), user #1 
	Any OGG-Net board via netmail to user #1 ("The Oggman") of Infinity's Edge
	GEnie:  PMP (Internet pmp@genie.geis.com)
	Delphi:  PMP (Internet pmp@delphi.com)

______________________________________________________________________



Introduction

        Welcome to PMPUnzip!  This program will extract files stored in ZIP archives originating on the PC and several other platforms.  Basically, ZIP archives are to the PC world what ShrinkIt archives are to the Apple world.  ZIP archives are created on the PC using PKWare's  PKZIP utility (shareware price $25 from PKWare).  ZIP archives contain one or more files that have been compressed and stored.   PMPUnzip will recognize ZIP archives, display a list of the files contained in the archive, and will allow you to extract one or more of these files to your Apple IIGS.  It should work fine for any archive ZIPped with PKZIP version 2.04g or below.


Features

		Access to all files stored in ZIP archives, including files that were stored,
		shrunk, reduced, imploded, or deflated (NEW!!).
		Access to full pathnames stored in ZIP archives, including any
		subdirectories in the archive.
		All ZIP file extraction routines are written in 65816 assembly language
		for speed.
		Multiple ZIP files may be open at one time.
		Multiple info windows may be brought up on any of the files in any open
 		archive.  
		Info windows contain more information on the file, including
 		modification date and time, compressed size, and more.
		Archive comments!  Using a proprietary PC character font, PMPUnzip
 		will display in the IBM character set any comment included in the ZIP 
		archive.  Many PC bulletin boards will have information screens
 		included inside ZIP files using PC graphic characters.  These will show
 		up as they were meant to look.
		The last modified time and date (as stored with the ZIP archive) will be
 		retained in the extracted file.
		NEW!!  Version 2.0 will now automatically convert text files created on
 		other platforms to the Apples CR-delimited text file format.
		NEW!!  PMPUnzip now has an option for extracting files in the
 		background.  This allows you to use NDAs while extracting, and allows
 		you to use other applications at the same time when operating under
 		multitasking software, such as The Manager by Seven Hills Software.
		NEW!!  PMPUnzip now keeps preferences so you can customize how
 		you want the program to work.
		Disk functions.  PMPUnzip includes the ability to format or erase a
 		volume and change the attributes on a file.
		MessageCenter aware!  PMPUnzip will allow opening of ZIP files from
 		The Finder (or any Finder-like program that passes file information
 		between applications via the MessageCenter) by either double-clicking
 		on the file's icon or by choosing the file and selecting "Open" from the
 		Finder's "File" menu. You can also have multiple ZIP files selected
 		when you select "Open" and PMPUnzip will open them all.
		Appleshare and other FST compatible.  Since PMPUnzip uses GS/OS
 		and the toolbox for all of its disk and file access, it will just as easily
 		open a ZIP archive on an HFS or Appleshare volume as it will a
 		ProDOS volume.
		Single-disk friendly.  PMPUnzip was designed to work with single-disk
 		users.  You will be prompted for which disk to insert during an
		extraction.
		Most text used in PMPUnzip is stored as resources and can be
		modified by any resource editor.  For instance, text can be translated
 		into different languages without having to write an entirely different
 		version of the program.


Requirments

        PMPUnzip requires System Disk 5.0 or better to run.  It also requires that the PC.MS.10 font (included with the program) be installed in the */SYSTEM/FONTS directory.  PMPUnzip uses resources, so be careful which file copy utility you use when copying the PMPUnzip file (and this document file).


Installing PMPUnzip

	1.	Copy the PMPUnzip application file (using a resource-aware
		copy program such as The Finder or ProSel-16) to whichever
		volume and directory you wish to put it.

	2.	Copy the PC.MS.10 font file to your */SYSTEM/FONTS directory.

	3.	Copy the PMPUnzip.Icons file to your */ICONS directory.

	4.	Using your favorite icon editor (such as IconED), load in the
 		PMPUnzip.Icons icon file that you copied to your */ICONS
		directory.  Edit the icon labeled "*.ZIP" and change the
		"Application to Run" field of the icon to the pathname of
		the PMPUnzip application on your system.  For instance, if
		you copied the application to /HD/Utilities/, you would
		change this field to /HD/Utilities/PMPUnzip.



Running PMPUnzip

	To run PMPUnzip, simply double-click on its icon from The Finder or execute it using whichever method your program launcher employs.

	There are also other ways to run PMPUnzip.  If you double-click on a ZIP file icon (basically, any file whose name ends in a ".ZIP" ) from The Finder, PMPUnzip will be run and will automatically open the ZIP archive that you clicked.  If you select several ZIP icons from The Finder and then select "Open" from The Finder's "File" menu, PMPUnzip will run and open all of the ZIP archives you have selected.


Menu Command Descriptions

	Below is a list of all of the menu commands that PMPUnzip recognizes.


Apple Menu

About PMPUnzip

	This brings up the "About" dialog for the program.  It also gives some information on other programs I've written for the Apple IIGS.  Remember, PLEASE send in your shareware fee!


File Menu

Open ZIP File(s)

	This command will bring up a file dialog and allow you to choose ZIP archives to open.  This is a standard "MultiGet" file dialog with two radio buttons under the file list.  By clicking on the radio button labeled "Show All Files," all files in a particular subdirecory will be shown.  By clicking on the radio button labeled "Show Only .ZIP Archives" (the default setting), only files ending with .ZIP will be shown.

	To open an archive, highlight it and click the "Open" or "Accept button,  or double click on the file entry in the list.  PMPUnzip also allows you to open multiple archives at the same time.  To select multiple archives, hold down the Apple button while you click on each file.  They will each appear highlighted.  You can also select a range of archives by clicking on the first archive, holding down the Shift key and selecting another archive.  All files inbetween and including the files clicked on will be selected.  To open multiple archives, you must select the "Accept" button.

	Whenever you open an archive, an archive window will appear displaying the various files contained in the archive (see Archive Windows, below).

Close

	This closes the top window on the desktop, including any NDA windows.

Close All Info Windows
Close All Comment Windows

	These menu items will only be displayed if there are any comment or info windows on the desktop.  These were included because a potentially great number of these windows (especially info windows) can be opened at once, thus slowing down the system.  These commands will close all of the appropriate type of window (see Info Windows and Comment Windows, below).

Stack Windows

	While running PMPUnzip, you will be able to open multiple ZIP archives, many different  information windows for any of the files, and comment windows to display the archives comments.  After awhile, your desktop may become cluttered and messy.  This menu item will stack all of your windows in neat piles, info windows on the bottom, then comment windows, and archive windows on the top.  Your currently active window will remain on top and selected.

Modify File Attributes...

	This option will allow you to modify certain attibutes an any file in your system, including file type, aux type, and all of the access bits.  A file dialog will be brought up allowing you to choose any file (including "invisible" files).  You will then see the attribute dialog.  File types and aux types are shown in hexadecimal.  Just type in the new value for these in the appropriate edit line.  To modify the access bits, just click on the appropriate check boxes.  To cancel the changes, click in the "Cancel" button or hit escape.  To save the changes, click in the "Change" button or hit return.

Keystroke Equivalents:

	Delete checkbox		Open Apple-D
	Rename checkbox		Open Apple-N
	Backup checkbox		Open Apple-B
	Invisible checkbox		Open Apple-I
	Write checkbox		Open Apple-W
	Read checkbox		Open Apple-R
	Cancel button		Escape
	Change button		Return

Preferences...

	This menu item will display a dialog box with the various system settings displayed.  You can change these settings and save them back to disk.  PMPUnzip saves your preferences in the invisible PMPUnzip.Prefs file in the same directory in which the program resides.

	The system settings that may be changed within this dialog box are as follows:

File Type for Extracted Files
	This menu pop-up lets you choose what file type is used for extracted files.  There are three different settings.  Use Archival Types will intelligently choose either Text or Binary files depending on the internal file attributes of the file stored in the archive.  Text will make all extracted files type TXT ($04) on the IIGS, and Binary will make all extracted files type BIN ($06) on the IIGS.

Prompt Before Overwriting Existing Files
	This check box allows you to choose the default setting of the Prompt before Overwrite check box located in the Extract file dialog (explained below).

Convert Text Files to CR
	This check box allows you to choose the default setting of the Convert Text Files check box located in the Extract file dialog (explained below).

Extract in the Background
	This option tells PMPUnzip how you want it to extract files.  If this box is not checked, PMPUnzip will bring up a dialog-type box when extracting files.  With this type of box, the thermometer is updated (and pending events taken care of) only when a chunk of the extracted file is being written to disk.
	If this item is checked, PMPUnzip will use a standard movable window when extracting files.  The thermometer will also be updated at a rate depending upon the Delay Factor setting (below), giving the desktop a more metered use of CPU time.  This can slow down the extraction (depending on the Delay Factor), but allows you to use NDAs while your archive is being extracted.  If you are using a multitasker, such as Seven Hill's The Manager, setting this option will allow you to run other programs while extracting a ZIP file!

Delay Factor
	This option specifies how much of a delay will occur between each update of the thermometer during a background extract.  A value of 1 means that the thermometer is updated after each byte of the file (or there about) has been extracted.  A value of 150 (the default) will update the thermometer after ever 150 or so bytes of the file have been extracted, etc.  As a point of reference, when you extract with the dialog box, deflated files update the thermometer after ever 32K (equivalent Delay Factor of 32768 or so), while other extraction methods update after 8K (8192 or so).  The lower the value, the more responsive NDAs and other applications will be when you extract in the background, and the slower the extraction will be.  Set this value depending on the speed of your GS and your personal tastes.

Force Extracted Name to Fit ProDOS
	Normally, PMPUnzip will check the FST of the target volume when extracting files.  If the volume is formatted for ProDOS, PMPUnzip will validate the file name of the extracted file to make sure it conforms to the ProDOS file naming conventions.  If the volume uses another file system, PMPUnzip passes the file name as-is to GS/OS.
	If this option is checked, all file names are validated to conform to ProDOS, even if the volume uses some other filing system.  This allows you to unZIP an archive onto, say, a Mac diskette, cause all extracted files to be made ProDOS-legal, then allow you to take that diskette to another Apple II and copy the files without having to rename them to something else.


Quit

	This will quit PMPUnzip and return you to the launching program.


Edit Menu

Undo
Cut
Copy
Paste
Clear

	These items are included for NDA support and have no use in PMPUnzip.  Whenever a PMPUnzip-owned window is displayed, these items will be dimmed.

Select All

	This command will allow you to select all of the files listed in the currently selected archive window.  This item is dimmed if the top window is not an archive window.


Disk Menu

Format a Disk...
Erase a Disk...

	These items allow you to format or erase a particular GS/OS device.  Formatting consists of a complete physical initialization of a disk or other device (assuming that the device allows physical formatting).  Erasing merely gets rid of any files on a previously formatted disk.

	When you choose one of these items, a list of the various block devices currently in your system will be displayed.  To prevent accidental formatting of hard drives, only floppy disks and RAM disks are selectable.  All others are dimmed and non-selectable, but are included in the list to let you know the types and sizes (in kilobytes) of the different devices.  When a block device is selected, you can click in the "Eject" button to eject any diskette, or click "Accept" to begin the procedure (either format or erase).  Clicking in "Cancel" (or hitting escape) will cancel the procedure.  You can also begin the procedure by double-clicking on the device name.

Keystroke Equivalents:

	Eject button		Open Apple-E
	Cancel button		Escape
	Accept button		Return


 Window Descriptions

	PMPUnzip displays three types of main windows; archive windows, comment windows, and info windows.  Archive windows display the contents of a ZIP archive that you have opened.  Comment windows display the file comment associated with a particular archive.  Info windows display additional information about a particular file.  When extracting files, the extract window appears.

	Other dialog-type windows will appear for various reasons when you use PMPUnzip, such as for renaming files and inserting volumes.  These windows all have keystroke equivalents to their control buttons.  All default (double border) buttons will respond to the Return key.  All Cancel buttons will respond to Escape.  All other buttons will respond to Open Apple plus the starting letter of their names.


 Archive Windows

	When you open an archive, you will see an archive window appear on the desktop.  The archive window contains a list of the various files included in the archive, including the file's name, tits apparent file type, the compression method used on that file, the percentage of the original size the compressed version is, and the real (uncompressed) length of the file.  If the file name is too large to fit in the space provided (for example, it contains one or more subdirectories before the name), three "dots" and the last part of the file name will be displayed only.  If the file is encrypted, a key icon will appear next to the name (note that version 2.0 of PMPUnzip does not support decryption).  The info bar at the top of the window contains the operating system the archive was created by and the version of the ZIP software used.

	On the right hand side of the window, you will find three buttons.  The "Extract" (default) button will extract the selected files from the archive (see Extract Window, below).  You will be prompted for which directory to put the files into.  The "Info" button will generate an info window (see Info Windows, below) for each file you have selected.  Finally, the "Comment" button will display the comment stored with the archive.  This button will only be enabled if a comment exists for this archive (see Comment Windows, below).

	To select a file for extraction or to get info on it, click on the file name (it will become highlighted).  You can also use the Apple key when clicking on files to choose different files within the archive, or use the Shift key to select a range of files.

Keystroke Equivalents:

	Info button			I
	Comment button		C
	Extract button		Return
	Scroll the file list		Up and Down arrows


Extract Window

	When you click the "Extract" button on an archive window, you will first be prompted for the destination directory where the files will be extracted to.  There are two special check boxes in this dialog.  The first check box will determine whether or not you will be prompted if an extracted file already exists in the destination directory.  If this check box is checked and an extracted file already exists in the destination directory, a dialog box will appear asking you whether you want to overwrite the file, rename it, skip it and go to the next extracted file, or cancel the extraction.  If the file being extracted contains subdirectories, you will also have the opportunity to change the subdirectory name(s).

	The other check box controls whether or not PMPUnzip will convert text files to Apple format.  If this check box is set, and the file type of the extracted file is text (determined by the first preference setting.  See the Preferences... menu item above), all Carriage Return/Line Feed combinations (PC format) and Line Feeds by themselves (Unix format) will be converted to just a Carriage Return.  This will make the extracted file compatible with any text editor used on the Apple II or IIGS.

	When you have selected the destination directory, the extract window will appear.  Depending on the Background option chosen in the preferences, this window with either be a dialog box or a standard window.

	This window will show extraction information on each of the files as they are extracted.  It will display the name of the originating archive, the name of the file (in the same format as the file list window), the compession method used (Imploded, Shrunk, Reduced, Stored, or Deflated), the compressed and uncompressed file sizes, and finally a thermometer bar that shows you the percentage of the extraction that has been completed.  The thermometer will turn more and more red as the file is being extracted.  When the current file is completely extracted, the thermometer will clear and information on the next file will appear.

	Note that PMPUnzip will automatically check the file name for illegal characters if the target volume uses the ProDOS file system.  However, if the target volume is NOT ProDOS, but is formatted to conform to another file system such as Mac HFS or AppleTalk, no file name checking is done, unless the Force ProDOS option is set in the Preferences.  Instead, PMPUnzip will attempt to extract the file as it finds it.  If the file name is not accepted, you will be prompted to enter a new name.  To force ProDOS file naming conventions on all media, set the Force ProDOS option in the Preferences.  See Preferences... above for more details.

	If you want to cancel an extraction, click on the "Stop" button in the extraction window or hit Escape.  It might take a second or two for the program to realize that you've clicked the button if the extract window is a dialog box (the backgroud extraction window should respond right away to the click).

	If you are extracting in the background, you will be allowed to move the extract window around, and open NDAs and the like.  You cant perform any other PMPUnzip function (the appropriate menus will be disabled) and the buttons in the Archive Windows will not do anything.  You will also be able to swit ch applications if you are using a multitasker or a task switcher (The Manager by Seven Hills Software and SwitchIt! by Procyon are two examples).   The archive will continue to be extracted while you are doing other things.  When it is finished, the extract window will disappear and you will be able to perform other PMPUnzip functions.


Comment Windows

	If you download a ZIP archive from your local PC bulletin board, it will more than likely have a comment stored in it.  This comment is printed out whenever you run the PKUNZIP program on a PC.  Normally, the comment contains an ad for the bulletin board that the ZIP archive originated from, or possibly some information on the archive.

	If an archive contains a comment, the "Comment" button in the archive window will be enabled.  When you click on this button, a window will be brought up displaying the comment using the actual PC character set.  This is because most comments contain special line drawing and other characters that look quite different on the IIGS.

	The comment window will have red stripes in the title bar.


Info Windows

	When you click in the "Info" button on the archive window, an info window will be generated for each file you have selected in the file list.  These info windows contains additional information on the file, including the compression method used, any compression options, the file type, the compessed and uncopmressed  length of the file, the time and date that the file was last modified, any file security, and the 32-bit CRC (cyclical reduncancy check) of the actual, uncompressed file (this value is used to ensure there are no errors when the file is extracted).  The name of the file and the file's archive are also shown in the info bar region of the window.

	The info window will have blue stripes in the title bar.


 Additional Notes and Subjective Comments Version 2.0

New  Compession Method  - It has been over a year since I put PMPUnzip 1.0 (and 1.01 and 1.02) out.  During that time, the PC world has gone over to a new ZIP file format, version 2.0.  Version 2.0 is exactly the same as previous versions, except that a new compession method was added:  deflation.  Deflation is quite a bit different than the other methods (though there are some similarities between it and imploded files) and was a bit more difficult to implement, but PMPUnzip Version 2.0 now has full support for delfated files.  This means that PMPUnzip will now extract  imploded, shrunk, reduced, stored, and deflated files in ZIP archives.

Dawn of the Multitasker  -  The lastest and potentially greatest addition to the IIGS software library is the task switching program.  Several such programs have surfaced, such as The Manager from Seven Hills and SwitchIt! from Procyon.  These progarms allow you to run several different applications on your IIGS at the same time.  The Manager also allows you to perform some tasks in the background, if, and heres the big if, if your program is written with multitasking in mind.  Well, PMPUnzip Version 2.0 was written with multitasking in mind!  It has no Manager-specific code, but it does do what Seven Hills says a good multi-tasking program should do.  If Extract in Background is turned on in the preferences, the old extract dialog box from version 1.0 is replaced with a normal modeless window.  This window can be moved around, and other windows can be selected (and NDAs pulled down).  Instead of hogging all of the CPU time for itself, this window stays in contact with the event manager at much more frequent intervals (depending upon the Delay Factor you set).  This, of course, means that file extractions are slowed down quite a bit.

	When using The Manager, set the Application Options for PMPUnzip so that Can Receive Null Events and Can Release Null Events are both checked.

	Remember:  if you want speedy extracts, turn the background extraction option off.  If you want to use NDAs or a multitasker/task switcher while extracting, turn the background extract option on.

Errors -  Again, with Version 2.0, I've taken great pains to make sure that PMPUnzip handles any errors it receives.  Those errors that are not explicitly taken care of will simply be displayed and the function will be cancelled.  
	I've also tried putting it through countless crash tests.  Since version 2.0 is based upon version 1.0 (and uses much of the same code), it was already pretty crash-free.  The big error-causer was creating the new inflation routines, which took me quite a while to debug.  These work just fine.  I also had to change around the way the extract stack/direct pages were used (which was kinda silly in version 1.0), cut direct page usage down to be more multitasker-friendly, change the way the extract window was udpated to make it more compatible with multitaskers, and some other changes.

Limitations -  Limitations?!  We dont need no stinking limitations!!  Actually, version 2.0 is pretty complete.  As with version 1.0, it does not support file comments (I have yet to find an archive with file comments to test), and it also does not support encrypted files.  I have the decryption code, but I seriously dont think the effort to put it in would be worth it, since 99.99% of the ZIP archives out there are not encrypted.  If this is a big deal, and if I get enough requests, Ill put it in.
	And, of course, PMPUnzip does NOT support ZIPping!!  This is an unZIP program, not a ZIP program!  ZIPping is a whole new ballgame and there are many things to consider when making a ZIP program for the Apple IIGS.  There is a discussion going on on GEnie (my category 38) about what features would be needed for the Apple II.  If you have comments about this, call GEnie and post away!

Programming -  The majority of the code for PMPUnzip (both 1.0 and 2.0) was written in Orca/C 1.3 (I havent gotten 2.0 yet), though I didn't use any routines in the Orca library (I wrote my own string manipulation routines, for instance).  As for the extraction routines, these were written in Orca/M 2.0 (a friend of mine was generous enough to give me his 2.0).  I again used Genesys for editing my resources (still the best and most complete resource editor available on the IIGS), and only used LLRE once for version 2.0.  I am still not partial to Prizm, so all of the source was written in the Orca text-based EDITOR.  For these docs, I am using the EGOed v1.9 editor NDA by Steve Disbrow and Joe Wankerl.  This gives me the benefit of actually being inside and running PMPUnzip while Im writing the docs!

 Speed -  I stuck with the tradition of using assembly language to write all of my extraction routines.  The old routines from 1.0 were not changed much.  They were, again, based upon some C code I found in the public domain written by Samuel H. Smith.  I have since found out that much of that code was taken from  unzip50 for Unix and other systems written by Mark Adler.  In fact, the C source for the new inflation routines was taken from unzip50 patch level 1, last updated in January of 1993 (special thanks go to Soenke Behrens for telling me about unzip50).
	I dont have much to base the extraction speed of the new inflate code on, but the assembly code I wrote is about twice the speed of the C source it is based upon (yes, I do have a partially-working APW  unZIP program  that works with 2.04g!).

Commentary (As the Shareware Turns)  -  In the continuing saga of not getting any shareware contributions for my products, I have only received about 25 shareware fees in the last year for PMPUnzip 1.0.  I would first like to THANK those people who sent in their shareware fees from the bottom of my heart.  I would also like do some finger-shaking at all the people who are using PMPUnzip without supporting my efforts in creating it. Now, some of this might be contributed to the fact that PKZIP 2.0 came out about 3 months after PMPUnzip 1.0 was released, thus making my support of PKZIP 1.1 archives a bit moot, but still, 25 people out of the hundreds and thousands that are actually using this program is pretty pathetic.  Please, people, against common sense and my better judgement in general, I am still writing software for the Apple IIGS.  This is a very poor financial move for me, but I happen to like the machine.  If I dont get any support for, this software will cease to happen.


Credits

	I've already mentioned Samuel H. Smith, whos C routines helped me out with version 1.0.  Version 2.0's inflation routines were based upon C code in Mark Adlers unzip50 program (which can be found on just about any Unix site).  Again, none of the actual C routines were used in PMPUnzip; they were only used as references for creating the 65816 assembly language extraction routines that are incorporated inside PMPUnzip 2.0.

	I'd also like to AGAIN thank the users on my bulletin board, Infinity's Edge at (510) 820-9401, who are still putting up with busy signals, and the sysops of the OGG-Net Network for not complaining too much when their network sessions meet static.  Ive still only got this one little Apple IIGS...

	And Id also again like to thank all the Apple II users out there that have kept the dream alive for over 16 years.  Apple II Forever, folks!  Unlike ACI, we really mean it!!


Paul Parkhurst
Friday, July 9, 1993



 Blatant Plug for ANSITerm
_________________________________________________________________________
Introducing
ANSITerm Version 2.0!
          Telecommunications Software for the Apple IIGS

	Parkhurst Micro Products is proud to announce the latest version of itspopular telecommunications software ANSITerm... Version 2.0!  With almost triple the power and features of ealier versions, 2.0 takes the Apple IIGS to even higher dimensions than before!


EMULATIONS

	ANSITerm provides support for color PC-ANSI emulation, including the complete PC character set.  Now, you can call PC-based bulletin board systemsand other BBSs and services and see colors, line drawing, and other special symbols AS THEY WERE MEANT TO LOOK.  ANSITerm also supports ANSI cursor control with the arrow keys and application-programmable function keys.

	ANSITerm also supports "Special" emulation used in many Apple II-based terminal software and supported on most Apple II-based bulletin boards.

	New to Version 2.0, ANSITerm now also supports the popular VT-100 and VT-52 emulations.  All features and modes are supported, including inverse, underline, and bold text, special line draw characters (EXACTLY how they are supposed to look), double-wide and double-wide/double-high characters in VT-100, internal scroll regions, all special keypad and arrow key support (for both normal and application modes), function key support, local printing,Extended Keyboard support, and all modes except 132 column and flashing characters.


FILE TRANSFERS

	ANSITerm supports all standard file transfer protocols, including:

	 	ASCII Text
  		Xmodem, Xmodem-CRC, Xmodem-1K, Xmodem-4K
		Ymodem and Ymodem Batch
		Zmodem
		Kermit

	ANSITerm also supports an optional ProDOS-style information footer for xmodem, as well as both MS-DOS- and ProDOS-compatible ymodem and zmodem headers.  Zmodem features include a 16K streaming buffer (with an option for full-streaming if your hardware supports it), CRC-32, and skip/resume/rename capability.  Other featuers include auto-Binary II extraction, MS-DOS file name validation, auto-start capability for both zmodem and kermit, and character
pacing for ASCII sends (including echo option, line length, and CR to CR + space).


COLOR SCROLLBACK

	ANSITerm provides up to 8 megabytes of scrollback so you can review what hasgone off the top of your screen.  Scrollback also displays color and high-ASCII characters for ANSI emulation, mousetext characters for "Special" emulation, and all special characters for VT-100 and VT-52, including double-sized characters and invsere/bold/underline characters.

	Many features are included with scrollback, including text search, sending selections to disk, the printer, or to the editor, and various housekeeping features.


DIALING DIRECTORY

	Up to 34 different systems and services can be stored for easy access and auto-dialing.  Information stored for each includes baud rate (110 to 57,600 baud), emulation, data format, and up to a 31-digit phone number.  Auto-dialing
is fast and efficient and includes support for both verbal and numeric results, "busy" detection, and more.

	Version 2.0's dialing directory now has several new features, including 10 alternate dial strings which can be used in place of the default in case certain services require certain modem settings, multi-service dialing which will dial many services one after the other until a connection is established, a handy quick-dial feature, 10 special macros for each service in the dialing directory, and several other new enhancements and features (including learnable logon macros).


TEXT EDITOR

	Version 2.0 now has a full-screen text editor.  The editor can edit files of any size up to the available memory in your IIGS.  It has all standard editor features, including line wrap on or off, show control codes, block copy/delete/paste, definable block "quoting" for message replies, line/paragraph formatting, printing (including top/bottom/left/right margins,
line length, and more), send to modem, file appending, conversion to upper or lower case, high-ASCII support, CR/LF support for saving files, find and replace, extended keyboard support, to name the main features.  It uses the same custom SHR font and default colors the rest of the program uses for sharp, color text.


MACRO LANGUAGE

	Version 2.0 now also supports a full macro language.  All settings for AT can now be changed via macro commands.  62 macros are available for use at any one time, including 52 global system macros (accessable through Option-A through Z and Shift-Option-A through Z) and 10 service macros for each of the services in the dialing directory.  Standard macro features include sending text to the console, remote and console, and remote only, waiting for text from
the remote, getting a string from the remote or from the user (via a dialog box), setting the color, screen location, receiving and sending files, conditional branching between macros, a full set of file manipulation macros (including open, close, input and output, random access, and newline mode) and more.  The macro language includes 10 numeric and 10 string variables for use with the macros.

	Also included is learnable logon macro creation.  AT will monitor a call to a BBS or service and create a logon macro for you (which may be modified later on if you wish).

	All settings, such as baud rate, parity, all dialing directory and transfer options, and almost all other setting for ANSITerm may be modified and read using macros.


DISK UTILITIES

	Version 2.0 comes with a complete set of disk utilities, including multi-file copying, deleting, renaming, catalog (screen and hardcopy), setting file attributes, and disk initialization.  Version 2.0 will initialize both SmartPort devices and Disk ][s.


HIGH-SPEED MODEM SUPPORT

	Version 2.0 supports most every modem type, including several special drivers for high-speed modems such as the USRobotics HST, Hayes V-Series, Supra Fax Modem, and the Intel 9600ex. Baud rates can optionally be fixed at 19,200, 38,400, or 57,600 baud to get the best performance from your high-speed modem.  Version 2.0 also supports several handshaking cable designs, and new native-mode serial port drivers that by pass the IIGS firmware, giving you the fastest transfer rate available on the IIGS!!


OTHER FEATURES

	ANSITerm includes many other features, such as emulation file viewing,printer and print-screen support, buffered chat duplex, the ability to set the default foreground and background colors for all emulations, hardware break
key, show control codes, and cursor on and off.

	Version 2.0 sports many new enhancements and features.  The cursor shape can now be made into either an underscore or a block and will now blink at a user definable blink rate.  You can also set Version 2.0 to prompt on exit or not,
and handle carrier detection on startup or exit specially (either initialize anyway, don't initialize, or prompt before initializing) just in case your session was prematurely aborted, and an option to have the dialing directory automatically displayed upon startup.


AVAILABILITY

	ANSITerm Version 2.0 is currently available directly from Parkhurst Micro Products.  List price is $119.99, but for a limited time only, you can purchase ANSITerm Version 2.0 directly from Parkhurst Micro Products for the special introductory price of only $69.00!

	Parkhurst Micro Products accepts checks, MO's, Visa, and MasterCard.  Please include the following additional amount for shipping and handling:

	Continental US	$5.00
	AK, HI, Territories	$7.50
	Canada		$8.50
	Elsewhere		$15.00
          
	California residents, please add sales and local taxes.  Allow 10 days for delivery if paying with money order or credit card, 30 days for personal check.  Payment must be made in US funds drawn from a US bank.

	For more information, or for quantity pricing for retailers, please contact Parkhurst Micro Products at (510) 837-9098, or write to:  Parkhurst Micro Products, 2491 San Ramon Valley Blvd., Suite 1-317, San Ramon, CA, 94583, USA.

